.TH std::forward_list::pop_front 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::forward_list::pop_front \- std::forward_list::pop_front

.SH Synopsis
   void pop_front();  \fI(since C++11)\fP

   Removes the first element of the container. If there are no elements in the
   container, the behavior is undefined.

   References and iterators to the erased element are invalidated.

.SH Parameters

   \fI(none)\fP

.SH Return value

   \fI(none)\fP

.SH Complexity

   Constant.

.SH Exceptions

   Does not throw.

.SH Example


// Run this code

 #include <forward_list>
 #include <iostream>

 int main()
 {
     std::forward_list<char> chars{'A', 'B', 'C', 'D'};

     for (; !chars.empty(); chars.pop_front())
         std::cout << "chars.front(): '" << chars.front() << "'\\n";
 }

.SH Output:

 chars.front(): 'A'
 chars.front(): 'B'
 chars.front(): 'C'
 chars.front(): 'D'

.SH See also

   push_front inserts an element to the beginning
              \fI(public member function)\fP
   front      access the first element
              \fI(public member function)\fP
